package com.gengzp.mq.server.mapper;

import com.gengzp.mq.common.model.entity.GengzpMqTopic;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * @ClassName GengzpMqTopicMapper
 * @Description 消息队列模块主题管理mapper层接口
 * @Author gengzp
 * @Date 2025/7/10 10:17
 */
@Mapper
public interface GengzpMqTopicMapper {

    /**
     * 根据名称查询已存在的主题
     *
     * @param topicName 主题名
     * @return 主题信息
     */
    GengzpMqTopic selectTopicByName(@Param("topicName") String topicName);

    /**
     * 根据id查询主题
     *
     * @param id 主题id
     * @return 主题信息
     */
    GengzpMqTopic selectTopicById(@Param("id") Long id);

    /**
     * 插入一条topic信息
     *
     * @param mqTopic topic信息
     */
    void insertTopic(GengzpMqTopic mqTopic);

    /**
     * 根据id编辑topic信息
     *
     * @param mqTopic topic信息
     */
    void updateTopicById(GengzpMqTopic mqTopic);

    /**
     * 根据id删除topic
     *
     * @param id topicId
     */
    void deleteTopicById(@Param("id") Long id);

    /**
     * 分页查询主题信息
     *
     * @param offset      偏移量
     * @param pageSize    每页数据条数
     * @param topic       主题名
     * @param description 描述
     * @return 主题列表
     */
    List<GengzpMqTopic> pageQueryGengzpMqTopic(@Param("offset") Integer offset,
                                               @Param("pageSize") Integer pageSize,
                                               @Param("topic") String topic,
                                               @Param("description") String description);

    /**
     * 查询总数
     *
     * @param topic       主题名
     * @param description 描述
     * @return 总数
     */
    Integer selectCountGengzpMqTopic(@Param("topic") String topic,
                                     @Param("description") String description);

    /**
     * 查询topic主题名集合
     *
     * @return 主题名集合
     */
    List<String> selectTopicNames();

}
